home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Atari Forever 4
/
Atari Forever 4.zip
/
Atari Forever 4.iso
/
_GRAFIK
/
IMG
/
HERALDIK
/
IMGSHOW.TXT
< prev
Wrap
Text File
|
1998-03-14
|
7KB
|
180 lines
======================================================================
".IMG Slide Show"
IMGSHOW.PRG
(c) Copyright 1989 Migraph, Inc.
All Rights Reserved
Version 1.1 1/31/89
======================================================================
This program is NOT public domain,
but may be distributed free of charge
provided this doc file accompanies the program.
Distribution with commercial applications is FORBIDDEN, unless prior
written consent is acquired from Migraph, Inc.
----------------------------------------------------------------------
This .IMG Slide Show program (IMGSHOW.PRG) allows the viewing of
monochrome .IMG files on any resolution ST. (Low, Med, Hi & Viking 1)
The user has control over speed, titles, slide order and other
attributes through the use of an optional script file. You may specify
multiple search paths and/or filenames with full wildcard support.
* Optional file information about each slide
* Black or white background
* Cycling or non-cycling slide show
* Key pause after each image or controllable time delay
----------------------------------------------------------------------
Script files:
----------------------------------------------------------------------
When the slide show is run, the command line is first checked for
pathnames and/or filenames. If found, the slide show proceeds. If not,
the current directory is searched for the script file "IMGSHOW.LST".
If found, the script file is parsed and the slide show continues.
Otherwise, "#*.img" is used as the search path, where '#' is the
current directory. When this is the case, the slides in the directory
will be shown in alphabetical order and you will be presented with a
dialog box to choose display options from.
Script files may contain the following fields (all are optional,
and can be in any order), default settings are given in brackets. The
user should specify 'Y','y','N', or 'n' following the field to indicate
whether they would like the option enabled or suppressed.
INFO: Indicate whether to show file information [no]
TINYINF: Shall info be displayed in a line at the top of
the screen or in a box at the right hand side
[use box except in low-res]
BLACK: Indicate whether the background behind the slide
shall be black or white [no]
CYCLE: Shall the slideshow start over at end [no]
KEY: Wait for keystroke before displaying next slide [yes]
SPEED: Value of 1,2, or 3 representing short, medium and
long screen delays before displaying next slide [2]
The next two fields don't take a letter after the field name:
PATH:
FILE:
The 'PATH:' field consists of a list of pathnames to be searched
one after another. If a full pathname is present (ie. "A:\IMGS\*.img"),
then that is the search path used. If a path is present without a filename
("A:\IMGS\"), the FILE list is scanned one at a time to complete the full
pathname. Wildcards may be used in the filename only. Up to 10 paths may be
specified.
The 'FILE:' field consists of a list of filenames (and filenames
ONLY, paths will be stripped, ie. "A:\IMGS\*.img" will be read as "*.img")
to be processed one at a time. Again, you may include wildcards or use
full filenames.
Field names MUST BE UPPER CASE and MUST CONTAIN THE COLON.
Blank lines are ignored and anything after a semi-colon on a line
is considered to be a comment.
The following is a sample script file:
--------------------------------------
; Sample IMGSHOW script file
; anything after a semi-colon is a comment
;
INFO:Y ; show file info. default is no
BLACK:Y ; use a black background. default is no
KEY:Y ; wait for keypress after each slide. default is pause
;
PATH:
c:\pics\*.img
c:\images\
f:\imgs\touchup.img
;
FILE:
tiger?.img
ss*.img
The above script file will display the pictures with file
information on top of a black background. Slides will not advance
without a keypress. The first PATH entry will cause all .img files
found in the "pics" folder on drive C to be displayed. Since this is
a full pathname, the file list is ignored for this path. After this,
the second PATH entry is processed. Since it is a pathname only
(no filename), each of the FILE entries in turn is appended to the
path to form complete search pathnames (ie. the first path searched
will be "c:\images\tiger?.img", then "c:\images\ss*.img"). Finally,
the third PATH entry is processed. It's a complete filename and the
FILE list is ignored.
----------------------------------------------------------------------
The Command Line:
----------------------------------------------------------------------
'PATH:' entries can be entered on the command line of various
shells (ie. GULAM, MSH). You may need to enclose your paths in single
quotes depending upon your shell.
----------------------------------------------------------------------
Install Application:
----------------------------------------------------------------------
You may also use Install Application from the desktop to install
IMGSHOW.PRG as file type IMG. This will let you double-click an .IMG
file to display it.
----------------------------------------------------------------------
Keyboard commands:
----------------------------------------------------------------------
The following key commands are accepted while the slideshow is
running:
SPACE.......... Pause at the current pic, any key resumes
(does not pause if key pause is in effect)
HELP........... Toggle file info on/off
UNDO........... Toggle background color between black and white
Up Arrow....... Display previous slide
F1............. Show a screen of other information
ESCAPE......... Abort slideshow
Holding down the left mouse button also aborts the slideshow.
Note: Some .IMG files take a while to load and sometimes keypresses
won't seem to take effect until after the next slide. Also, keys
should not be pressed too quickly after one another or commands may be
lost.
----------------------------------------------------------------------
We hope this program makes your use of .IMG files more
enjoyable and productive. Comments or problems may be
addressed to:
Migraph, Inc.
200 S 333rd St (220)
Federal Way, Wa. 98003
phone lines 9-5 PST weekdays:
1-800-223-3729 Order line
1-206-838-4677 Product support
Online support -
GEnie address: MIGRAPH-TECH
Category 28 in ST Roundtable